home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / pine394.zip / README.OS2
Text File  |  1996-06-26  |  5KB  |  127 lines
  1. -------------------------------------------------------------
  2. This is Pine for OS/2, a text mode IMAP-capable mail and news
  3. client for 32-bit OS/2, including OS/2 version 2.0 and later.
  4. -------------------------------------------------------------
  5.  
  6. This version of Pine is a network client, and requires you to
  7. have IBM TCP/IP 2.0 or later installed. The OS/2 Warp IAK is
  8. sufficient to run this program across either a SLIP or PPP
  9. link.
  10.  
  11. Note on mailboxes: The default mailbox type uses the IMAP
  12. v2bis protocol. To use IMAP, you will need to be connecting
  13. to a mail server with an IMAP server that supports IMAP
  14. version 2 or later. Pine may also be used with POP v2 or v3
  15. servers, but is not as functional by a large margin.
  16.  
  17. To define an IMAP mailbox, you enter the following:
  18.  
  19. {your.mail.server.fdqn}INBOX          for your standard mailbox
  20. {your.mail.server.fdqn}path/folder    for other mail folders
  21.  
  22. To define a POP3 style mailbox, you enter:
  23.  
  24. {your.mail.servers.fdqn/pop3}INBOX
  25.  
  26. Note that POP only supports one mailbox on your server - that
  27. is the standard mailbox for incoming mail.
  28.  
  29. This version of Pine uses smtp delivery only, and is not
  30. suitable for an OS/2 system set up as a mail server. That
  31. would require a great many changes to the c-client system
  32. (for OS/2, at least).
  33.  
  34. Local mail folders created and maintained by PineOS2 are in
  35. "dawz" format, which is identical to the format used by the
  36. MSDOS and Windows builds of Pine. This version of Pine is
  37. also able to read "Berkeley" style mail folders, but only in
  38. read- only mode. Since you can copy between folders using the
  39. S)ave command from the mail folder index, you can move mail
  40. freely from Berkeley format mail folders to dawz, but not the
  41. reverse.
  42.  
  43. If you wish to log in automatically to your server without
  44. having to specify a login name or password each time, create
  45. an empty file called "PINE.PWD" in the same directory where
  46. Pine creates its PINERC configuration file.
  47.  
  48. Before running Pine, set either the HOME environment
  49. variable, or the PINEHOME variable (if you have other
  50. software that uses HOME but wish to place Pine elsewhere) in
  51. your CONFIG.SYS - and remember to reboot.
  52.  
  53. Files in the "bin" subdirectory should be placed somewhere in
  54. your PATH. Files in the "dll" subdirectory should be placed
  55. in a directory that is specified in your LIBPATH setting.
  56. Files under the "emx" subdirectory should also be placed into
  57. a directory in your LIBPATH, but check first to ensure that
  58. there are no other files of the same name on your system.
  59. These files come from the EMX runtime version 0.9b, and you
  60. will need these or the equivalent later versions to run Pine
  61. without problems.
  62.  
  63. For the convenience of WPS users, this version of Pine
  64. includes a -w <lines> command line switch which sets the
  65. window size by the number number of lines to which Pine
  66. should set Vio window. The INSTPINE.CMD supplied simply
  67. creates an object on your desktop a some typical setting
  68. and allows you to select the standard desktop size you wish
  69. to use. You can change this on the fly by a shell to the
  70. prompt via ^Z (assuming this has been enabled), using the
  71. "mode" command to set the number of lines, then "exit" back
  72. to Pine.
  73.  
  74. When you run INSTPINE.CMD, you must be in the same directory
  75. as pine.exe.
  76.  
  77. Sample scripts are provided as a sample of how you might
  78. configure Pine to automatically sign messages with PGP,
  79. and verify signatures on incoming messages so signed.
  80. You need to have PGP installed correctly with a valid
  81. secret and/or public keyring on your system before these
  82. scripts will be of any use.
  83.  
  84. The "misc" subdirectory contains a program called "addff"
  85. which may be configured as a filter via the Custom Printer
  86. to add a formfeed after all output is done (Pine's internal
  87. "formfeed" setting only adds a formfeed BETWEEN messages,
  88. but does not add one at the end). Read the comments in
  89. the .c source file for program use.
  90.  
  91.                       -----
  92.  
  93. Please read the documentation carefully before email the
  94. porter for technical support, and do so only as a last
  95. resort. Due to many other committements, at this I am not
  96. able to guarantee prompt response to email. Bug reports, on
  97. the other hand, are always welcome.
  98.  
  99. OS/2 Port: David Nugent
  100.     Email: davidn@blaze.net.au
  101.   FidoNet: 3:632/348@fidonet
  102.  
  103.  
  104.   -- BUILDING PINE --
  105.  
  106. The port to OS/2 has been incorprated into the standard
  107. Pine source distribution, which can be found at
  108.  
  109.   ftp://ftp.cac.washington.edu/pine/pine3.94.tar.gz.
  110.  
  111. Before building PineOS2, you will need:
  112.  
  113.   emx 0.9b development system and gcc 2.7.2 or later
  114.   gnu make
  115.   gnu shell utilities or functional equivalents (cp,rm,mv)
  116.  
  117. All can be obtained from the OS/2 archives at hobbes.nmsu.edu.
  118.  
  119. You will also need to convert the files build.cmd in the
  120. Pine source root directory and imap\ANSI\c-client\drivers.cmd
  121. from "UNIX" newline delimited files to standard DOS CRLF
  122. files so that IBM REXX will be able to read them
  123. correctly. Other than that, just type 'build' and that should
  124. build Pine for OS2 with no further action necessary.
  125.  
  126.  
  127.